Control properties
Control Properties
Each control has a set of properties that allow you to manipulate their behavior and visual presentation in the Work Portal.
To display a control's properties, click on the control or select the Properties icon (FormsComponents147) located on its upper boundary. The properties will display in the Left panel.
The properties are contained in three tabs: Basic, Format, and Advanced.
Basic Tab
Displays a list of the core properties of the control. Properties highlighted with a red asterisk are mandatory. Setting the Basic properties alone will result in the default behavior of the control in the Work Portal.
| Property | Description |
|---|---|
| Display name | This is the name of the attribute that will be shown in the Work Portal. |
| Help text | Contains the help text for this control. This context help is activated by the Help (FormsComponents148) icon on the control's upper boundary. |
| Data source | Relates the control to an attribute of the data model. |
| Visible | Sets the visibility of the control. This can be determined by an expression. |
| Editable | Determines if the control is editable or read-only and can be set by an expression. |
| Required | Defines if the control is mandatory or optional and can be determined by an expression. |
The Visible, Editable, and Required properties allow you to either define if a control ALWAYS exhibits the same behavior or evaluate an expression (or business rule) to determine the behavior. To learn more about evaluating expressions for these properties, please refer to Manage properties with expressions.
IMPORTANT: You can change some properties of multiple controls at the same time by selecting them while holding the Ctrl key. This will enable the Basic tab with the properties you can manage.
Format Tab
Applies to most of the form controls and enables you to customize the appearance of the control in the form.
| Property | Description |
|---|---|
| Display type | Enables different visual formats in respect to the text (label) and the control (value). This includes hiding either the label or the value. |
| Label and value horizontal align | Aligns the label and value of the control within the space available in the Form. |
| Orientation | Defines if the text should be written from left to right or vice versa. The Inherited option indicates the property will be set according to the language selected in the Work Portal. |
| Format options | Changes the look of the control value or of the control label by customizing the size and formatting; for example font type, font style, and background color. |
| Layout | Defines the percentage to distribute the control in the space available in the work area. When the value for Select format is Percentage, it splits the space into different width columns based on a percentage ratio. When the value for Select format is Pixels, Bizagi sets a fixed label width in pixels, the maximum value that can be set is 999 pixels. By default, it is a two-column split with a 50/50 width distribution. |
IMPORTANT: You can change some properties of multiple controls at the same time by selecting them while holding the Ctrl key. This will enable the Format tab with the properties you can manage.
Display Type Example
Layout Example
Using percentage distribution
Using fixed pixels
Advanced Tab
The Advanced tab contains the properties that are exclusive to the control to allow advanced configuration and customize its behavior.